Fast Lookup Of Related Data Partitioned Across A Distributed Key-Value Store

ABSTRACT

A storage cluster includes a plurality of key-value storage nodes categorized into sub-groups of data associated with a first value identifying the sub-group and second values identifying respective subsets of data. A key-value processing system receives at least one of a first request to retrieve a selected one of the sub-groups of data, the first request including a plurality of keys, each of the plurality of keys including the first value and a respective one of the second values, and a second request to retrieve a selected one of the subsets of data. The second request includes a key having the first value and a selected one of the second values. The selected one of the second values corresponds to a hash value. The storage cluster selectively provides at least one of the selected one of the sub-groups of data and the selected one of the subsets of data.

CROSS-REFERENCE TO RELATED APPLICATIONS

The present application is related to U.S. patent application Ser. No. ______, (USPTO Ref. No. 98052-36-US-01/402106-US-NP) filed on [the same day]. The entire disclosure of the application referenced above is incorporated by reference.

FIELD

The present disclosure relates to key-value lookup systems and methods for a distributed data storage system.

BACKGROUND

The background description provided herein is for the purpose of generally presenting the context of the disclosure. Work of the presently named inventors, to the extent the work is described in this background section, as well as aspects of the description that may not otherwise qualify as prior art at the time of filing, are neither expressly nor impliedly admitted as prior art against the present disclosure.

Network systems may implement distributed data storage for storing application data, user data, etc. The data storage is accessible (e.g., either directly or indirectly) to a large number of clients, including tenants (e.g., customers) and individual users associated with respective tenants. Clients query a server to retrieve specific data from the distributed data storage. In some examples, queries are executed according to a protocol such as standard query language (SQL), NoSQL, etc.

Some distributed data storage systems implement a key-value database. In a key-value database, a key-value cluster includes one or more key-value servers or nodes storing respective data. Accordingly, data is distributed across multiple key-value servers. Clients transmit a request for data that includes a key mapped to one or more values representing specific data. A key-value cluster receives the request and retrieves the data from the appropriate key-value server based on the included key. For example, the key-value cluster may implement a key-value table that stores key-value pairs to enable retrieval of data (i.e., the value) paired with respective key.

SUMMARY

A storage cluster for a distributed network system includes a plurality of key-value storage nodes, each of the storage nodes to store data categorized into sub-groups of data, and each of the sub-groups of data associated with a first value identifying the sub-group and second values identifying respective subsets of data within the sub-group. A key-value processing system is to receive, from one of a plurality of client devices, at least one of a first request to retrieve a selected one of the sub-groups of data, the first request including a plurality of keys, each of the plurality of keys including the first value and a respective one of the second values, and a second request to retrieve a selected one of the subsets of data within the selected one of the sub-groups, the second request including a key, the key including the first value and a selected one of the second values. The selected one of the second values corresponds to a hash value. The storage cluster is to selectively provide at least one of the selected one of the sub-groups of data and the selected one of the subsets of data in response to a respective one of the first request and the second request.

A system includes a storage cluster including a plurality of key-value storage nodes, each of the storage nodes to store data categorized into sub-groups of data. Each of the sub-groups of data is associated with a first value identifying the sub-group and second values identifying respective subsets of data within the sub-group. The system further includes a plurality of client devices, each of the client devices to at least one of generate a first request to retrieve a selected one of the sub-groups of data, the first request including a plurality of keys and each of the plurality of keys including the first value and a respective one of the second values, and generate a second request to retrieve a selected one of the subsets of data within the selected one of the sub-groups. The second request includes a key including the first value and a selected one of the second values, and the selected one of the second values corresponds to a hash value. The storage cluster is to selectively provide at least one of the selected one of the sub-groups of data and the selected one of the subsets of data in response to a respective one of the first request and the second request.

A method includes storing, in a storage cluster including a plurality of key-value storage nodes, data categorized into sub-groups of data, each of the sub-groups of data associated with a first value identifying the sub-group and second values identifying respective subsets of data within the sub-group, receiving, from one of a plurality of client devices, at least one of a first request to retrieve a selected one of the sub-groups of data, the first request including a plurality of keys and each of the plurality of keys including the first value and a respective one of the second values, and a second request to retrieve a selected one of the subsets of data within the selected one of the sub-groups. The second request includes a key, the key includes the first value and a selected one of the second values, and the selected one of the second values corresponds to a hash value. The method further includes selectively providing at least one of the selected one of the sub-groups of data and the selected one of the subsets of data in response to a respective one of the first request and the second request.

A method includes storing, in a storage cluster including a plurality of key-value storage nodes, data categorized into sub-groups of data, each of the sub-groups of data associated with a first value identifying the sub-group and second values identifying respective subsets of data within the sub-group, generating, at each client device of a plurality of client devices, at least one of a first request to retrieve a selected one of the sub-groups of data, the first request including a plurality of keys and each of the plurality of keys including the first value and a respective one of the second values, and a second request to retrieve a selected one of the subsets of data within the selected one of the sub-groups. The second request includes a key, the key includes the first value and a selected one of the second values, and the selected one of the second values corresponds to a hash value. The method further includes selectively providing at least one of the selected one of the sub-groups of data and the selected one of the subsets of data in response to a respective one of the first request and the second request.

A key-value processing system for a key-value server including a plurality of key-value storage nodes includes a processor and a tangible machine readable medium. The machine readable medium stores machine readable instructions that, when executed by the processor, configure the key-value processing system to categorize stored data into sub-groups of data, each of the sub-groups of data associated with a first value identifying the sub-group and second values identifying respective subsets of data within the sub-group, to receive, from one of a plurality of client devices, at least one of a first request to retrieve a selected one of the sub-groups of data, the first request including a plurality of keys, each of the plurality of keys including the first value and a respective one of the second values, and a second request to retrieve a selected one of the subsets of data within the selected one of the sub-groups, the second request including a key, the key including the first value and a selected one of the second values, and the selected one of the second values corresponding to a hash value, and to selectively provide at least one of the selected one of the sub-groups of data and the selected one of the subsets of data in response to a respective one of the first request and the second request.

A system includes a storage cluster including a plurality of key-value storage nodes, each of the storage nodes to store sub-groups of data corresponding to a respective tenant of a plurality of tenants, and each of the sub-groups of data associated with a first value identifying the respective tenant and second values identifying respective users within the tenant. The system further includes a plurality of client devices associated with the tenant, each of the client devices to generate a first type of request to retrieve a selected one of a plurality of subsets of data corresponding to the respective users within the tenant, the first type of request including a key, the key including a primary field and a secondary field, the primary field including an identifier of the respective tenant, and the secondary field including a hashed username of one of the respective users. Each of the client devices is further to generate a second type of request to retrieve an entire sub-group of data of the respective tenant. Generating the second type of request includes generating a plurality of the keys, each of the plurality of the keys includes the primary field including the identifier of the respective tenant, and each of the plurality of keys includes the second field including a hashed username of a different one of the respective users.

Further areas of applicability of the present disclosure will become apparent from the detailed description, the claims and the drawings. The detailed description and specific examples are intended for purposes of illustration only and are not intended to limit the scope of the disclosure.

BRIEF DESCRIPTION OF DRAWINGS

FIG. 1A is an example distributed network system that implements key-value systems and methods according to the principles of the present disclosure.

FIG. 1B is an example client device that implements key-value systems and methods according to the principles of the present disclosure.

FIG. 1C is an example server that implements key-value systems and methods according to the principles of the present disclosure.

FIG. 2 is an example key-value storage system according to the principles of the present disclosure.

FIG. 3 is an example key-value table according to the principles of the present disclosure.

FIG. 4 is an example key-value lookup method according to the principles of the present disclosure.

In the drawings, reference numbers may be reused to identify similar and/or identical elements.

DESCRIPTION

A key-value database may attempt to evenly partition data across a plurality of nodes (i.e., key-value servers) in a key-value cluster. In some examples, a hash function is used on one or more portions of a key. For example, each key-value server may be associated with a range of possible hash values to distribute load across the key-value servers, and the hash function is used to determine where a corresponding data entry is stored. However, the portion of the key that is hashed using the hash function may include components that are not evenly distributed with respect to data volume. In other words, different hash values may correspond to different data volumes. Accordingly, evenly distributing hash values does not necessarily result in evenly distributed data.

Key-value systems and methods according to the principles of the present disclosure selectively allow lookup and retrieval of data according to tenant (e.g., customer) or according to one or more individual users of the tenant. For example, a key may include a primary field corresponding to the tenant and a secondary field appended to the primary field. The secondary field corresponds to an individual user (e.g., a username associated with the tenant). A hash function is applied to the secondary field to index a subset of the individual users to a particular value in the key-value server. Accordingly, in some examples, the key is used to retrieve data of the subset of users indicated by the hashed secondary field. Conversely, in other examples, the key is used to retrieve an entire sub-group of data associated with the tenant. For example, the key-value server may retrieve the entire sub-group of data using the primary field by iterating through a range of hash values of the secondary field.

In this manner, data may be more evenly distributed across a plurality of key-value servers in a key-value cluster. Further, the key may be used to retrieve the entire sub-group of data or only data for a subset of users associated with a single hash value. In some examples, the range of possible hash values may be selected according to whether more even distribution (i.e., a greater range of hash values) or retrieving the requested data with fewer queries (i.e., a smaller range of hash values) is desired.

FIG. 1A shows a simplified example of a distributed network system 100 implementing the key-value systems and methods of the present disclosure. The distributed network system 100 includes a network 110, one or more client devices 120-1, 120-2, . . . , and 120-M (collectively client devices 120), and one or more servers 130-1, 130-2, . . . , and 130-N (collectively servers 130). The network 110 may include a local area network (LAN), a wide area network (WAN) such as the Internet, or other type of network (collectively shown as the network 110). For example, the servers 130 may be located at different departments and different geographical locations of an enterprise (e.g., servers including, but not limited to, cloud-based servers). The client devices 120 communicate with the server 130 via the network 110. The client devices 120 and the server 130 may connect to the network 110 using wireless and/or wired connections to the network 110.

For example, the client devices 120 may include smartphones, personal digital assistants (PDAs), laptop computers, personal computers (PCs), and so on. The server 130 may provide multiple services to the client devices 120. For example, the server 130 may execute a plurality of software applications developed by one or more vendors. The server 130 may host multiple databases that are utilized by the plurality of software applications and that are used by users of the client devices 120.

The client devices 120 and the servers 130 implement key-value data storage and retrieval. For example, two or more of the servers 130 may correspond to key-value servers in a key-value cluster (i.e., a storage cluster) 140, and two or more of the client devices 120 may correspond to individual users of a tenant 144 or, in some examples, front-end applications used by the tenant 144. One or more of the client devices 120 may execute applications that write data to the key-value cluster 140 in accordance with a key including a primary field and a hashed secondary field. Others of the client devices 120 execute applications that retrieve data from the key-value cluster 140 in accordance with the key. For example, the key-value cluster 140 is configured to selectively retrieve an entire sub-group of data of the tenant 144 associated with the primary field of the key and/or retrieve only data of a subset of users of the tenant 144 associated with the hashed secondary field as described below in more detail.

FIG. 1B shows a simplified example of the client device 120. The client device 120 may typically include a central processing unit (CPU) or processor 150, one or more input devices 152 (e.g., a keypad, touchpad, mouse, and so on), a display subsystem 154 including a display 156, a network interface 158, a memory 160, and a bulk storage 162.

The network interface 158 connects the client device 120 to the distributed network system 100 via the network 110. For example, the network interface 158 may include a wired interface (e.g., an Ethernet interface) and/or a wireless interface (e.g., a Wi-Fi, Bluetooth, near field communication (NFC), or other wireless interface). The memory 160 may include volatile or nonvolatile memory, cache, or other type of memory. The bulk storage 162 may include flash memory, a hard disk drive (HDD), or other bulk storage device.

The processor 150 of the client device 120 executes an operating system (OS) 164 and one or more client applications 166. The client applications 166 include an application to connect the client device 120 to the server 130 via the network 110. The client device 120 accesses one or more applications executed by the server 130 via the network 110. The processor 150 in combination with one or more of the client applications 166, the network interface 158, etc. implements the key-value systems and methods of the present disclosure. For example, the client device 120 selectively writes data to the servers 130 and/or retrieves data from the servers 130 in accordance with a key-value store as described below in more detail.

FIG. 1C shows a simplified example of the server 130. The server 130 typically includes one or more CPUs or processors 170, one or more input devices 172 (e.g., a keypad, touchpad, mouse, and so on), a display subsystem 174 including a display 176, a network interface 178, a memory 180, and a bulk storage 182.

The network interface 178 connects the server 130 to the distributed network system 100 via the network 110. For example, the network interface 178 may include a wired interface (e.g., an Ethernet interface) and/or a wireless interface (e.g., a Wi-Fi, Bluetooth, near field communication (NFC), or other wireless interface). The memory 180 may include volatile or nonvolatile memory, cache, or other type of memory. The bulk storage 182 may include flash memory, one or more hard disk drives (HDDs), or other bulk storage device.

The processor 170 of the server 130 executes an operating system (OS) 184 and one or more server applications 186, which may include the key-value systems and methods of the present disclosure. The bulk storage 182 may store one or more databases 188 that store data structures used by the server applications 186 to perform respective functions.

FIG. 2 shows an example key-value storage system 200 according to the present disclosure. The key-value storage system 200 includes a tenant 204 and associated client devices 204-1, 204-2, . . . , and 204-M (collectively client devices 204). The client devices 204 write data to and retrieve data from a key-value cluster 212 including key-value servers 216-1, 216-2, . . . , and 216-N (collectively key-value servers 216). The client devices 204 communicate with the key-value cluster 212 via network 220. Although not shown, the tenant 204 may be one of a plurality of tenants configured to access the key-value cluster 212.

The client devices 204 may implement any of the components of the client device 120 described in FIG. 1B but are simplified in FIG. 2 for example purposes. For example, each of the client devices 204 may execute one or more client applications 224 and may include a respective key-value processing system 228 (e.g., as implemented using the processor 150, the memory 160 and corresponding applications, etc.) as described below in more detail. Similarly, the key-value cluster 212 and/or the key-value servers 216 may implement any of the components of the server 130 described in FIG. 1C but are simplified in FIG. 2 for example purposes. For example, the key-value cluster 212 may include a key-value processing system 232 (e.g., as implemented using the processor 170, the memory 180 and corresponding applications, etc.) as described below in more detail. For example only, the key-value processing system 232 of the key-value cluster 212 may be implemented within one of the key-value servers 216, a separate server, a machine in a same geographic location as the key-value servers 216 (e.g., in a dedicated machine in a rack or same physical locations as the key-value servers 216), etc. In some examples, each of the key-value servers 216 may implement a respective key-value processing system 232.

One or more of the client devices 208 is configured to store (i.e., write) data to the key-value cluster 212. Data is stored to the key-value cluster 212 using a key configured according to the principles of the present disclosure. For example, the client device 208-1 may generate a write request to store data to the key-value cluster 212. The key-value processing system 228 of the client device 208-1 generates a key 236 corresponding to the write request. The key 236 includes a primary field x and a secondary field h(y), where x identifies the tenant 204, y identifies a user (e.g., the client device 208-1) associated with the tenant 204, and h(y) corresponds to a hashed value of y. For example, the key-value processing system 228 applies a hash function to y to obtain the hashed secondary field h(y). The key-value cluster 212 stores the data associated with the write request to one of the key-value servers 216 according to the key 236.

One or more of the client devices 208 may also be configured to retrieve data from the key-value cluster 212 according to a key 240 or keys 244. For example only, the client device 208-2 generates a read request (e.g., a query) to retrieve data associated with a particular user. Accordingly, the key-value processing system 228 of the client device 208-2 generates the key 240 including the primary field x and the secondary field h(y), where y identifies the user of the client device 208-2. For example, the key-value processing system 228 of the client device 2-8-2 applies a hash function to y to obtain the hashed secondary field h(y). The key-value cluster 212 retrieves the data of the client device 208-2 associated with the read request according to the key 240.

Conversely, the client device 208-M generates a plurality (e.g., p, where p corresponds to a hash range of the hash function h(y)) of read requests (i.e., queries) to retrieve an entire sub-group of data associated with the tenant 204. Accordingly, the key-value processing system 228 of the client device 208-M generates p keys 244 including the primary field x and a secondary field indicating one of an entire range of hash values (e.g., 0, 1, . . . , p) corresponding to the tenant 204. The key-value cluster 212 retrieves the entire sub-group of data of the tenant 204 associated with the read request according to the keys 244.

In some examples, the key-value processing system 232 of the key-value cluster 212 may be configured to direct a received request 248 to a respective one of the key-value servers 216. For example, each of the key-value servers 216 may store a different portion of the data of a plurality of tenants, including the tenant 204. Accordingly, the key-value processing system 232 may store data (e.g., a log or table) associating the tenants with one or more of the key-value servers 216, associating each key with a particular one of the key-value servers 216, etc. In other examples, each of the key-value servers 216 may receive every request 248.

In an example where a number N of the key-value servers 216 N is 3, each of the servers 216 stores and retrieves data according to example key-value tables (e.g., a hash table) 300-1, 300-2, . . . , and 300-3, respectively (collectively key-value tables 300) as shown in FIG. 3. The tables 300 represent data stored as key-value pair objects. For example, the servers 216 each store, in non-volatile memory, a respective portion of the data of tenants as key-value pairs. For simplicity, FIG. 3 illustrates example storage of data for only four tenants (1-4), each having four users (1-4) for a total of sixteen data entries (data_01 through data_16). In other words, a key structure x|h(y) for four tenants and a hash range of four maps to four sub-groups of tenant data and a total of sixteen data entries. However, a key-value cluster such as the key-value cluster 212 may include hundreds of the key-value servers 216 configured to store data for hundreds or thousands of the tenants 204 and hundreds of thousands of users.

Each of the keys includes a primary field (e.g., 1, 2, 3, or 4) identifying a tenant and a secondary field (e.g., 1, 2, 3, or 4) corresponding to a hashed value identifying a specific user. For example, the hashed value may correspond to a hashed username, such as a login name or email address of the user (e.g., username@domain.com). In other words, the hash function is applied to the username to calculate the secondary field of the key. In the present example, each username for a tenant hashes to a unique hash value 1-4. In other examples as described below in more detail, multiple usernames may hash to a same hash value. In other words, the hash range p may be less than a total number of users of a tenant.

For example, the key-value table 300-1 stores data corresponding to keys 1|1, 1|2, 2|2, 2|4, 3|1, 3|2, 3|3, and 3|4, the key-value table 300-2 stores data corresponding to keys 1|3, 2|1, 2|3, and 4|1, and the key-value table 300-3 stores data corresponding to keys 1|4, 4|2, 4|3, and 4|4. Accordingly, a sub-group of data corresponding to each of the tenants 1-4 may be portioned across different ones of the servers 216. For example, the table 300-1 may store all of the data of tenant 1, only a portion of the data of tenants 1 and 2, and none of the data of the tenant 4. Conversely, the table 300-2 stores only a portion of the data of each of tenants 1, 2, and 4, and none of the data of tenant 3. The table 300-3 stores portions of the data of tenants 1 and 4 and none of the data of tenants 2 and 3.

Accordingly, rather than distributing data across the servers 216 based on an even distribution of tenants and/or data entries (i.e., hash values, usernames, etc.), the data is instead distributed based on an even distribution of data. In other words, while the table 300-1 stores a greater number of key-value pairs (i.e., data entries) than the tables 300-2 or 300-3, the overall amount of data stored by each of the tables 300 may be more evenly distributed. For example, the data entries corresponding to tenant 3 (data_09 through data_12) may include an overall smaller amount of data than the data entry for key 4|1 (data_13).

In this manner, data may be more evenly distributed across the key-value servers 216 by allowing the sub-group of data of the tenant 204 to be distributed across multiple ones of the servers 216 without duplicating the data. Further, the entire sub-group of data for the tenant 204 may be retrieved by providing the keys 244 corresponding to all of the users (i.e., client devices 208) of the tenant 204 to the key-value cluster 212, and data corresponding to only a single user or subset of users may be retrieved by providing the key 240 including a hash value as described above.

The hash range p may be selected to balance distribution of data with a number queries required to retrieve the entire sub-group of data of the tenant 204. For example, a larger hash range results in a more even distribution of data across the servers 216 but requires a greater number of queries (e.g., equal to the hash range p) to retrieve all of the data entries of the tenant 204. Conversely, a lower hash range results in a less even distribution of the data, but a smaller number of queries to retrieve all of the data entries of the tenant 204.

In one example where the hash range p is selected to be 8191, retrieving the entire sub-group of data for the tenant 204 would require 8192 queries (including keys x|0 through x|8191). If the total number of usernames is less than 8192, then each username could be hashed to a unique hash value and a data entry corresponding to a single user could be retrieved with each key. However, if the total number of usernames is significantly greater than 8192 (e.g., 100,000), then multiple usernames would hash to each hash value and a query for a single user would retrieve data associated with multiple usernames. The requesting client device would then filter the retrieved data to select only the data of the associated username. Further, achieving a more even distribution across the servers 216 would be more difficult since multiple usernames hashing to the same hash value could result in different hash values being paired with significantly different volumes of data.

Conversely, increasing the hash range p (e.g., to 65535) would increase the number of queries required to retrieve the entire sub-group of data for the tenant 204, but decrease the number of usernames associated with the same hash value. For example, using the example of 100,000 usernames, each hash value may be associated with only one or two usernames, on average. However, distribution of usernames may not necessarily be even across the hash values and, in some examples, more than two usernames may be associated with some hash values while only one username is associated with other hash values. Accordingly, increasing the hash range p would result in a more even distribution of the data of the 100,000 users across the servers 216 while requiring significantly more queries to retrieve all of the data of the tenant 204.

FIG. 4 shows an example key-value lookup method 400 beginning at 404. At 408, the method (e.g., a client application 224 of one of the client devices 216) generates a request to retrieve data. At 412, the method 400 (e.g., the key-value processing system 228) determines whether to retrieve data associated with a specific username (e.g., as opposed to an entire sub-group of data of the tenant 204). If true, the method 400 continues to 416. If false, the method 400 continues to 420. At 416, the method 400 (e.g., the key-value processing system 228) generates a key corresponding to the requested data. For example, the key may include a primary field including a tenant identifier (e.g., x) and a secondary field including hash value h(y), where y corresponds to the username. At 424, the method 400 (e.g., the key-value processing system 228) transmits a query including the key to the key-value cluster 212. At 428, the method 400 (e.g., the client device 216) receives the data corresponding to the key included with the query. The method 400 ends at 432.

At 420, the method 400 (e.g., the key-value processing system 228) generates a key corresponding to the requested data. For example, the key may include a primary field including a tenant identifier (e.g., x) and a secondary field including a value 1−p, where p is a hash range associated with the data stored for the client device 216. At 436, the method 400 (e.g., the key-value processing system 228) transmits a query including the key to the key-value cluster 212. At 440, the method 400 (e.g., the client device 216) receives the data corresponding to the key included with the query.

At 444, the method 400 (e.g., the key-value processing system 228) determines whether a query was transmitted for all possible values of the secondary field of the key associated with the client device 216. If true, the method 400 ends at 432. If false, the method 400 continues to 448. At 448, the method 400 (e.g., the key-value processing system 228) increments the value of the secondary field and generates a corresponding key at 420. In this manner, the method 400 cycles through all possible values in the hash range p to generate p queries and retrieve the entire sub-group of data of the tenant 204.

The foregoing description is merely illustrative in nature and is in no way intended to limit the disclosure, its application, or uses. The broad teachings of the disclosure can be implemented in a variety of forms. Therefore, while this disclosure includes particular examples, the true scope of the disclosure should not be so limited since other modifications will become apparent upon a study of the drawings, the specification, and the following claims. It should be understood that one or more steps within a method may be executed in different order (or concurrently) without altering the principles of the present disclosure. Further, although each of the embodiments is described above as having certain features, any one or more of those features described with respect to any embodiment of the disclosure can be implemented in and/or combined with features of any of the other embodiments, even if that combination is not explicitly described. In other words, the described embodiments are not mutually exclusive, and permutations of one or more embodiments with one another remain within the scope of this disclosure.

Spatial and functional relationships between elements (for example, between modules, circuit elements, semiconductor layers, etc.) are described using various terms, including “connected,” “engaged,” “coupled,” “adjacent,” “next to,” “on top of,” “above,” “below,” and “disposed.” Unless explicitly described as being “direct,” when a relationship between first and second elements is described in the above disclosure, that relationship can be a direct relationship where no other intervening elements are present between the first and second elements, but can also be an indirect relationship where one or more intervening elements are present (either spatially or functionally) between the first and second elements. As used herein, the phrase at least one of A, B, and C should be construed to mean a logical (A OR B OR C), using a non-exclusive logical OR, and should not be construed to mean “at least one of A, at least one of B, and at least one of C.”

In the figures, the direction of an arrow, as indicated by the arrowhead, generally demonstrates the flow of information (such as data or instructions) that is of interest to the illustration. For example, when element A and element B exchange a variety of information but information transmitted from element A to element B is relevant to the illustration, the arrow may point from element A to element B. This unidirectional arrow does not imply that no other information is transmitted from element B to element A. Further, for information sent from element A to element B, element B may send requests for, or receipt acknowledgements of, the information to element A.

In this application, including the definitions below, the term “module” or the term “controller” may be replaced with the term “circuit.” The term “module” may refer to, be part of, or include: an Application Specific Integrated Circuit (ASIC); a digital, analog, or mixed analog/digital discrete circuit; a digital, analog, or mixed analog/digital integrated circuit; a combinational logic circuit; a field programmable gate array (FPGA); a processor circuit (shared, dedicated, or group) that executes code; a memory circuit (shared, dedicated, or group) that stores code executed by the processor circuit; other suitable hardware components that provide the described functionality; or a combination of some or all of the above, such as in a system-on-chip.

The module may include one or more interface circuits. In some examples, the interface circuits may include wired or wireless interfaces that are connected to a local area network (LAN), the Internet, a wide area network (WAN), or combinations thereof. The functionality of any given module of the present disclosure may be distributed among multiple modules that are connected via interface circuits. For example, multiple modules may allow load balancing. In a further example, a server (also known as remote, or cloud) module may accomplish some functionality on behalf of a client module.

The term code, as used above, may include software, firmware, and/or microcode, and may refer to programs, routines, functions, classes, data structures, and/or objects. The term shared processor circuit encompasses a single processor circuit that executes some or all code from multiple modules. The term group processor circuit encompasses a processor circuit that, in combination with additional processor circuits, executes some or all code from one or more modules. References to multiple processor circuits encompass multiple processor circuits on discrete dies, multiple processor circuits on a single die, multiple cores of a single processor circuit, multiple threads of a single processor circuit, or a combination of the above. The term shared memory circuit encompasses a single memory circuit that stores some or all code from multiple modules. The term group memory circuit encompasses a memory circuit that, in combination with additional memories, stores some or all code from one or more modules.

The term memory circuit is a subset of the term computer-readable medium. The term computer-readable medium, as used herein, does not encompass transitory electrical or electromagnetic signals propagating through a medium (such as on a carrier wave); the term computer-readable medium may therefore be considered tangible and non-transitory. Non-limiting examples of a non-transitory, tangible computer-readable medium are nonvolatile memory circuits (such as a flash memory circuit, an erasable programmable read-only memory circuit, or a mask read-only memory circuit), volatile memory circuits (such as a static random access memory circuit or a dynamic random access memory circuit), magnetic storage media (such as an analog or digital magnetic tape or a hard disk drive), and optical storage media (such as a CD, a DVD, or a Blu-ray Disc).

In this application, apparatus elements described as having particular attributes or performing particular operations are specifically configured to have those particular attributes and perform those particular operations. Specifically, a description of an element to perform an action means that the element is configured to perform the action. The configuration of an element may include programming of the element, such as by encoding instructions on a non-transitory, tangible computer-readable medium associated with the element.

The apparatuses and methods described in this application may be partially or fully implemented by a special purpose computer created by configuring a general purpose computer to execute one or more particular functions embodied in computer programs. The functional blocks, flowchart components, and other elements described above serve as software specifications, which can be translated into the computer programs by the routine work of a skilled technician or programmer.

The computer programs include processor-executable instructions that are stored on at least one non-transitory, tangible computer-readable medium. The computer programs may also include or rely on stored data. The computer programs may encompass a basic input/output system (BIOS) that interacts with hardware of the special purpose computer, device drivers that interact with particular devices of the special purpose computer, one or more operating systems, user applications, background services, background applications, etc.

The computer programs may include: (i) descriptive text to be parsed, such as JavaScript Object Notation (JSON), hypertext markup language (HTML) or extensible markup language (XML), (ii) assembly code, (iii) object code generated from source code by a compiler, (iv) source code for execution by an interpreter, (v) source code for compilation and execution by a just-in-time compiler, etc. As examples only, source code may be written using syntax from languages including C, C++, C#, Objective C, Haskell, Go, SQL, R, Lisp, Java®, Fortran, Perl, Pascal, Curl, OCaml, Javascript®, HTML5, Ada, ASP (active server pages), PHP, Scala, Eiffel, Smalltalk, Erlang, Ruby, Flash®, Visual Basic®, Lua, and Python®.

None of the elements recited in the claims are intended to be a means-plus-function element within the meaning of 35 U.S.C. § 112(f) unless an element is expressly recited using the phrase “means for,” or in the case of a method claim using the phrases “operation for” or “step for.” 

What is claimed is:
 1. A storage cluster for a distributed network system, the storage cluster comprising: a plurality of key-value storage nodes, each of the storage nodes to store data categorized into sub-groups of data, wherein each of the sub-groups of data is associated with a first value identifying the sub-group and second values identifying respective subsets of data within the sub-group; and a key-value processing system to receive, from one of a plurality of client devices, at least one of (i) a first request to retrieve a selected one of the sub-groups of data, wherein the first request includes a plurality of keys, wherein each of the plurality of keys includes the first value and a respective one of the second values and (ii) a second request to retrieve a selected one of the subsets of data within the selected one of the sub-groups, wherein the second request includes a key, wherein the key includes the first value and a selected one of the second values, and wherein the selected one of the second values corresponds to a hash value, wherein the storage cluster is to selectively provide at least one of the selected one of the sub-groups of data and the selected one of the subsets of data in response to a respective one of the first request and the second request.
 2. The storage cluster of claim 1, wherein the first value identifies a tenant associated with the storage cluster and the second values each identify a respective user within the tenant.
 3. The storage cluster of claim 2, wherein each of the second values correspond to a hashed username of the respective user.
 4. The storage cluster of claim 1, wherein each of the plurality of keys corresponds to x|h(y), wherein x is the first value, h(y) is the second value, y is a username associated with one of the subsets of data, and h(y) is a hash value resulting from applying a hash function to the username.
 5. The storage cluster of claim 1, wherein a first subset of data within a first sub-group of data is stored in a first one of the key-value storage nodes and a second subset of data within the first sub-group of data is stored in a second one of the key-value storage nodes.
 6. The storage cluster of claim 1, wherein, to generate the first request to retrieve the selected one of the sub-groups of data, each of the client devices is further to generate the plurality of keys such that each of the plurality of keys includes a different one of the second values.
 7. The storage cluster of claim 6, wherein the plurality of keys include p of the second values, wherein p is an integer greater than one, and wherein p corresponds to a hash range.
 8. The storage cluster of claim 7, wherein p is less than a quantity of users associated with a respective one of the sub-groups of data.
 9. A method comprising: storing, in a storage cluster including a plurality of key-value storage nodes, data categorized into sub-groups of data, wherein each of the sub-groups of data is associated with a first value identifying the sub-group and second values identifying respective subsets of data within the sub-group; receiving, from one of a plurality of client devices, at least one of (i) a first request to retrieve a selected one of the sub-groups of data, wherein the first request includes a plurality of keys, wherein each of the plurality of keys includes the first value and a respective one of the second values and (ii) a second request to retrieve a selected one of the subsets of data within the selected one of the sub-groups, wherein the second request includes a key, wherein the key includes the first value and a selected one of the second values, and wherein the selected one of the second values corresponds to a hash value; and selectively providing at least one of the selected one of the sub-groups of data and the selected one of the subsets of data in response to a respective one of the first request and the second request.
 10. The method of claim 9, wherein the first value identifies a tenant associated with the storage cluster and the second values each identify a respective user within the tenant.
 11. The method of claim 10, wherein each of the second values correspond to a hashed username of the respective user.
 12. The method of claim 9, wherein each of the plurality of keys corresponds to x|h(y), wherein x is the first value, h(y) is the second value, y is a username associated with one of the subsets of data, and h(y) is a hash value resulting from applying a hash function to the username.
 13. The method of claim 9, further comprising storing a first subset of data within a first sub-group of data in a first one of the key-value storage nodes and storing a second subset of data within the first sub-group of data in a second one of the key-value storage nodes.
 14. The method of claim 9, wherein generating the first request to retrieve the selected one of the sub-groups of data includes generating the plurality of keys such that each of the plurality of keys includes a different one of the second values.
 15. The method of claim 14, wherein the plurality of keys include p of the second values, wherein p is an integer greater than one, and wherein p corresponds to a hash range.
 16. The method of claim 15, wherein p is less than a quantity of users associated with a respective one of the sub-groups of data.
 17. A key-value processing system for a key-value server including a plurality of key-value storage nodes, the key-value processing system comprising: a processor; and a tangible machine readable medium storing machine readable instructions that, when executed by the processor, configure the key-value processing system to categorize stored data into sub-groups of data, wherein each of the sub-groups of data is associated with a first value identifying the sub-group and second values identifying respective subsets of data within the sub-group, receive, from one of a plurality of client devices, at least one of (i) a first request to retrieve a selected one of the sub-groups of data, wherein the first request includes a plurality of keys, wherein each of the plurality of keys includes the first value and a respective one of the second values and (ii) a second request to retrieve a selected one of the subsets of data within the selected one of the sub-groups, wherein the second request includes a key, wherein the key includes the first value and a selected one of the second values, and wherein the selected one of the second values corresponds to a hash value, and selectively provide at least one of the selected one of the sub-groups of data and the selected one of the subsets of data in response to a respective one of the first request and the second request.
 18. A storage cluster, comprising: the key-value processing system of claim 17; and the plurality of key-value storage nodes.
 19. A system comprising the storage cluster of claim 18, wherein each of the sub-groups of data corresponds to a respective tenant of a plurality of tenants, each of the first values identifies the respective tenant, and each of the second values identifies a respective user within the tenant, the system further comprising: a plurality of client devices associated with the tenant, each of the client devices to generate the first request to retrieve the selected one of the sub-groups of data, and generate the second request to retrieve the selected one of the subsets of data within the selected one of the sub-groups. 